home *** CD-ROM | disk | FTP | other *** search
XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn((((3333XXXX)))) NNNNAAAAMMMMEEEE XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn - The ArrowButton widget class SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////AAAArrrrrrrroooowwwwBBBB....hhhh>>>> VVVVEEEERRRRSSSSIIIIOOOONNNN This page documents version 1.2 of the Motif library. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN ArrowButton consists of a directional arrow surrounded by a border shadow. When it is selected, the shadow changes to give the appearance that the ArrowButton has been pressed in. When the ArrowButton is unselected, the shadow reverts to give the appearance that the ArrowButton is released, or out. CCCCllllaaaasssssssseeeessss ArrowButton inherits behavior and resources from CCCCoooorrrreeee and XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee classes. The class pointer is xxxxmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnnWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss. The class name is XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a .Xdefaults file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC prefix and use the remaining letters. To specify one of the defined values for a resource in a .Xdefaults file, remove the XXXXmmmm prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (C), set by using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is not applicable (N/A). XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ______________________________________________________________________________ XmNactivateCallback XmCCallback XtCallbackList NULL C XmNarmCallback XmCCallback XtCallbackList NULL C XmNarrowDirection XmCArrowDirection unsigned char XmARROW_UP CSG XmNdisarmCallback XmCCallback XtCallbackList NULL C XmNmultiClick XmCMultiClick unsigned char dynamic CSG XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk Page 1 (printed 4/30/98) XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn((((3333XXXX)))) Specifies a list of callbacks that is called when the ArrowButton is activated. To activate the button, press and release BBBBSSSSeeeelllleeeecccctttt while the pointer is inside the ArrowButton widget. Activating the ArrowButton also disarms it. The reason sent by this callback is XXXXmmmmCCCCRRRR____AAAACCCCTTTTIIIIVVVVAAAATTTTEEEE. XXXXmmmmNNNNaaaarrrrmmmmCCCCaaaallllllllbbbbaaaacccckkkk Specifies a list of callbacks that is called when the ArrowButton is armed. To arm this widget, press BBBBSSSSeeeelllleeeecccctttt while the pointer is inside the ArrowButton. The reason sent by this callback is XXXXmmmmCCCCRRRR____AAAARRRRMMMM. XXXXmmmmNNNNaaaarrrrrrrroooowwwwDDDDiiiirrrreeeeccccttttiiiioooonnnn Sets the arrow direction. The following are values for this resource: +o XXXXmmmmAAAARRRRRRRROOOOWWWW____UUUUPPPP. +o XXXXmmmmAAAARRRRRRRROOOOWWWW____DDDDOOOOWWWWNNNN. +o XXXXmmmmAAAARRRRRRRROOOOWWWW____LLLLEEEEFFFFTTTT. +o XXXXmmmmAAAARRRRRRRROOOOWWWW____RRRRIIIIGGGGHHHHTTTT. XXXXmmmmNNNNddddiiiissssaaaarrrrmmmmCCCCaaaallllllllbbbbaaaacccckkkk Specifies a list of callbacks that is called when the ArrowButton is disarmed. To disarm this widget, press and release BBBBSSSSeeeelllleeeecccctttt while the pointer is inside the ArrowButton. The reason for this callback is XXXXmmmmCCCCRRRR____DDDDIIIISSSSAAAARRRRMMMM. XXXXmmmmNNNNmmmmuuuullllttttiiiiCCCClllliiiicccckkkk If a button click is followed by another button click within the time span specified by the display's multi-click time, and this resource is set to XXXXmmmmMMMMUUUULLLLTTTTIIIICCCCLLLLIIIICCCCKKKK____DDDDIIIISSSSCCCCAAAARRRRDDDD, do not process the second click. If this resource is set to XXXXmmmmMMMMUUUULLLLTTTTIIIICCCCLLLLIIIICCCCKKKK____KKKKEEEEEEEEPPPP, process the event and increment _c_l_i_c_k__c_o_u_n_t in the callback structure. When the button is not in a menu, the default value is XXXXmmmmMMMMUUUULLLLTTTTIIIICCCCLLLLIIIICCCCKKKK____KKKKEEEEEEEEPPPP. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss ArrowButton inherits behavior and resources from the following superclasses. For a complete description of each resource, refer to the man page for that superclass. Page 2 (printed 4/30/98) XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn((((3333XXXX)))) XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ________________________________________________________________________________________________ XmNbottomShadowColor XmCBottomShadowColor Pixel dynamic CSG XmNbottomShadowPixmap XmCBottomShadowPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNforeground XmCForeground Pixel dynamic CSG XmNhelpCallback XmCCallback XtCallbackList NULL C XmNhighlightColor XmCHighlightColor Pixel dynamic CSG XmNhighlightOnEnter XmCHighlightOnEnter Boolean False CSG XmNhighlightPixmap XmCHighlightPixmap Pixmap dynamic CSG XmNhighlightThickness XmCHighlightThickness Dimension 2 CSG XmNnavigationType XmCNavigationType XmNavigationType XmNONE CSG XmNshadowThickness XmCShadowThickness Dimension 2 CSG XmNtopShadowColor XmCTopShadowColor Pixel dynamic CSG XmNtopShadowPixmap XmCTopShadowPixmap Pixmap dynamic CSG XmNtraversalOn XmCTraversalOn Boolean True CSG XmNunitType XmCUnitType unsigned char dynamic CSG XmNuserData XmCUserData XtPointer NULL CSG CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ______________________________________________________________________________________________________________ XmNaccelerators XmCAccelerators XtAccelerators dynamic CSG XmNancestorSensitive XmCSensitive Boolean dynamic G XmNbackground XmCBackground Pixel dynamic CSG XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderColor XmCBorderColor Pixel XtDefaultForeground CSG XmNborderPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderWidth XmCBorderWidth Dimension 0 CSG XmNcolormap XmCColormap Colormap dynamic CG XmNdepth XmCDepth int dynamic CG XmNdestroyCallback XmCCallback XtCallbackList NULL C XmNheight XmCHeight Dimension dynamic CSG XmNinitialResourcesPersistent XmCInitialResourcesPersistent Boolean True C XmNmappedWhenManaged XmCMappedWhenManaged Boolean True CSG XmNscreen XmCScreen Screen * dynamic CG XmNsensitive XmCSensitive Boolean True CSG XmNtranslations XmCTranslations XtTranslations dynamic CSG XmNwidth XmCWidth Dimension dynamic CSG XmNx XmCPosition Position 0 CSG XmNy XmCPosition Position 0 CSG CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn A pointer to the following structure is passed to each callback: ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{ iiiinnnntttt _r_e_a_s_o_n;;;; XXXXEEEEvvvveeeennnntttt * _e_v_e_n_t;;;; iiiinnnntttt _c_l_i_c_k__c_o_u_n_t;;;; }}}} XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnnCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt;;;; Page 3 (printed 4/30/98) XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn((((3333XXXX)))) _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback. _c_l_i_c_k__c_o_u_n_t This value is valid only when the reason is XXXXmmmmCCCCRRRR____AAAACCCCTTTTIIIIVVVVAAAATTTTEEEE. It contains the number of clicks in the last multiclick sequence if the XXXXmmmmNNNNmmmmuuuullllttttiiiiCCCClllliiiicccckkkk resource is set to XXXXmmmmMMMMUUUULLLLTTTTIIIICCCCLLLLIIIICCCCKKKK____KKKKEEEEEEEEPPPP; otherwise it contains 1111. The activate callback is invoked for each click if XXXXmmmmNNNNmmmmuuuullllttttiiiiCCCClllliiiicccckkkk is set to XXXXmmmmMMMMUUUULLLLTTTTIIIICCCCLLLLIIIICCCCKKKK____KKKKEEEEEEEEPPPP. TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss XmArrowButton includes translations for XmPrimitive. Additional XmArrowButton translations are listed below. These translations may not directly correspond to a translation table. BBBBSSSSeeeelllleeeecccctttt PPPPrrrreeeessssssss:::: AAAArrrrmmmm(((()))) BBBBSSSSeeeelllleeeecccctttt CCCClllliiiicccckkkk:::: AAAAccccttttiiiivvvvaaaatttteeee(((()))) DDDDiiiissssaaaarrrrmmmm(((()))) BBBBSSSSeeeelllleeeecccctttt RRRReeeelllleeeeaaaasssseeee::::AAAAccccttttiiiivvvvaaaatttteeee(((()))) DDDDiiiissssaaaarrrrmmmm(((()))) BBBBSSSSeeeelllleeeecccctttt PPPPrrrreeeessssssss 2222++++::::MMMMuuuullllttttiiiiAAAArrrrmmmm(((()))) BBBBSSSSeeeelllleeeecccctttt RRRReeeelllleeeeaaaasssseeee 2222++++::::MMMMuuuullllttttiiiiAAAAccccttttiiiivvvvaaaatttteeee(((()))) KKKKSSSSeeeelllleeeecccctttt:::: AAAArrrrmmmmAAAAnnnnddddAAAAccccttttiiiivvvvaaaatttteeee(((()))) KKKKHHHHeeeellllpppp:::: HHHHeeeellllpppp(((()))) Page 4 (printed 4/30/98) XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn((((3333XXXX)))) AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss The XmArrowButton action routines are described below: AAAAccccttttiiiivvvvaaaatttteeee(((()))): Draws the shadow in the unselected state. If the pointer is within the ArrowButton, calls the callbacks for XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk. AAAArrrrmmmm(((()))): Draws the shadow in the selected state and calls the callbacks for XXXXmmmmNNNNaaaarrrrmmmmCCCCaaaallllllllbbbbaaaacccckkkk. AAAArrrrmmmmAAAAnnnnddddAAAAccccttttiiiivvvvaaaatttteeee(((()))): Draws the shadow in the selected state and calls the callbacks for XXXXmmmmNNNNaaaarrrrmmmmCCCCaaaallllllllbbbbaaaacccckkkk. Arranges for the shadow to be drawn in the unselected state and the callbacks for XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk and XXXXmmmmNNNNddddiiiissssaaaarrrrmmmmCCCCaaaallllllllbbbbaaaacccckkkk to be called, either immediately or at a later time. DDDDiiiissssaaaarrrrmmmm(((()))): Draws the shadow in the unselected state and calls the callbacks for XXXXmmmmNNNNddddiiiissssaaaarrrrmmmmCCCCaaaallllllllbbbbaaaacccckkkk. HHHHeeeellllpppp(((()))): Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any exist. If there are no help callbacks for this widget, this action calls the help callbacks for the nearest ancestor that has them. MMMMuuuullllttttiiiiAAAAccccttttiiiivvvvaaaatttteeee(((()))): If XXXXmmmmNNNNmmmmuuuullllttttiiiiCCCClllliiiicccckkkk is XXXXmmmmMMMMUUUULLLLTTTTIIIICCCCLLLLIIIICCCCKKKK____DDDDIIIISSSSCCCCAAAARRRRDDDD, this action does nothing. If XXXXmmmmNNNNmmmmuuuullllttttiiiiCCCClllliiiicccckkkk is XXXXmmmmMMMMUUUULLLLTTTTIIIICCCCLLLLIIIICCCCKKKK____KKKKEEEEEEEEPPPP, this action does the following: Increments _c_l_i_c_k__c_o_u_n_t in the callback structure. Draws the shadow in the unselected state. If the pointer is within the ArrowButton, calls the callbacks for XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk. Calls the callbacks for XXXXmmmmNNNNddddiiiissssaaaarrrrmmmmCCCCaaaallllllllbbbbaaaacccckkkk. MMMMuuuullllttttiiiiAAAArrrrmmmm(((()))): If XXXXmmmmNNNNmmmmuuuullllttttiiiiCCCClllliiiicccckkkk is XXXXmmmmMMMMUUUULLLLTTTTIIIICCCCLLLLIIIICCCCKKKK____DDDDIIIISSSSCCCCAAAARRRRDDDD, this action does nothing. If XXXXmmmmNNNNmmmmuuuullllttttiiiiCCCClllliiiicccckkkk is XXXXmmmmMMMMUUUULLLLTTTTIIIICCCCLLLLIIIICCCCKKKK____KKKKEEEEEEEEPPPP, this action draws the shadow in the selected state and calls the callbacks for XXXXmmmmNNNNaaaarrrrmmmmCCCCaaaallllllllbbbbaaaacccckkkk. Page 5 (printed 4/30/98) XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn((((3333XXXX)))) AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr This widget has the additional behavior described below: <<<<EEEEnnnntttteeeerrrrWWWWiiiinnnnddddoooowwww>>>>: Draws the ArrowButton shadow in its selected state if the pointer leaves and re-enters the window while BSelect is pressed. <<<<LLLLeeeeaaaavvvveeeeWWWWiiiinnnnddddoooowwww>>>>: Draws the ArrowButton shadow in its unselected state if the pointer leaves the window while BSelect is pressed. VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss The bindings for virtual keys are vendor specific. For information about bindings for virtual buttons and keys, see VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX)))). RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN CCCCoooorrrreeee((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeAAAArrrrrrrroooowwwwBBBBuuuuttttttttoooonnnn((((3333XXXX)))), and XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX)))). Page 6 (printed 4/30/98) 
